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GTRANSCODE 




Transkoodaus on prosessi, jossa ääni- tai videotiedosto (tai joukko tiedostoja) muunnetaan 
yhdestä mediaformaatista toiseen. Linuxissa eräs parhaista sovelluksista tämän tekemiseen on 
Transcode, joka on komentoriviltä käytettävä sovellus. GTranscode on graafinen käyttöliittymä 
Transcode-komentorivisovellukselle. GTranscode helpottaa Transcoden käyttöä niille, jotka eivät 
ole tottuneet käyttämään komentoriviä, tai jotka eivät ole aiemmin kokeilleet transkoodausta. 

Asennus 
2. Asennus 
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GTRANSCODEN ASENTAMINEN 



Käyttääksesi GTranscodea joudut ensin asentamaan sen. Kun tämä on valmis, voit jatkaa 
seuraavasta luvusta. 

DEBIAN JA UBUNTU 

Näissä kahdessa käyttöjärjestelmässä asentaminen on hyvin helppoa. Itse asiassa sinun ei 
tarvitse asentaa Transcodea ensin, sillä näiden kahden käyttöjärjestelmän 
paketinhallintajärjestelmä asentaa Transcoden osana GTranscode -prosessia. Asentaaksesi 
molemmat sovellukset sinun tulee olla verkossa ja kirjoittaa seuraava komento päätteeseen 
(komentoriville): 

sudo apt-get install gtranscode 

Tämän yksinkertaisempaa siitä ei tule. Kirjoitat komennon ja sen jälkeen apt-get hakee oikeat 
tiedostot verkosta, lataa ne, konfiguroi ne ja asentaa ne. Tämän lisäksi apt-get -sovellus saa 
myös kaikki tiedostot ja kirjastot joista GTranscode riippuu, mukaan luettuna Transcoden 
tiedostot. 

Käyttö 

3. Käyttöliittymä 

4. Käyttö 
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GTRANSCODEN KÄYTTÖLIITTYMÄ 

Se on melko yksinkertainen käyttöliittymä, jossa on kätkettynä paljon tehokkaita vaihtoehtoja. 



Flle About 



Input 



Video Fie or Dlrectory |~" 


Browse 


Audio Flta ( opbonaJ)|~" 


Browse 


Import moduie 


I- j : :<r ii . f- r / 



frannes ( bianfc = ALI) *.g. f MS f 



Probed info aboul Input Video (audio not probed) 



Flle notyet probed. 



ProJ«t«f Output Fiie Siz& (for .avi fiies) 

Video Data Stee N/A MB 

Video Ov&mead Slze N/A MB 

Audio Data Sfee N/A MB 

Audio Oveitiead Size nm mb 

Toiai n/A M& 



Output 

OuipuC video Fiie | 
Video Optfcns 

A Direct SSrearn Copy fpass-ttiroughji 
v Full Frocessing Mode 



Audio Optfons 

A Direct Stream Copy (pass-tnrougn) 
v Full Processing Motte 



Brows& 



Tärkeimmät ohjelman käyttöliittymän osat ovat sisääntuloalue (Input) vasemmalla ja 
ulostuloalue (Output) oikealla. 

SISÄÄNTULO 

Tässä osassa valitset tiedostot, joita tahdot transkoodata (muuntaa). 
Tiedostonvalitsin 

Valitaksesi tiedoston tai hakemiston transkoodattavaksi, napsautat yksinkertaisesti Browse- 
nappia Video File or Directory -tekstin vieressä, ja tiedostoselain aukenee: 
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Create Dir Delete File Renarne File 



/home/eset _i 





Directories 


A 




Files 


A 




./ 
../ 

Desktop/ 
RealPlayer/ 
eliza/ 
extras/ 
g trans/ 


/ 




RealPlayer10GOLD.bin 

aco.tgz 

c:\traoe_b.txt 

gpodder_0.7-2_all.deb 

gtranscode-v0.3.tar.gz 

vlc-0.8.4a.tar.gz 

vlc-0.8.5.tar.gz 

wr-. .-, 


/ 



Selection: /home/eset 



OK Cancel 



Tietenkin voit luoda hakemistoja (Create Directories), poistaa tiedostoja (Delete Files) ja 
uudelleennimetä tiedostoja (Rename Files) tällä käyttöliittymällä, mutta yleensä tahdot käyttää 
sitä transkoodattavien tiedostojen valintaan. Kun olet selannut sen tiedoston kohdalle, jonka 
tahdot muuntaa toiseen muotoon, korosta se napsauttamalla tiedostonimeä ja paina OK. Jos 
tahdot transkoodata koko hakemiston, voit avata sen hakemiston kaksoisnapsauttamalla 
hakemiston nimeä tiedostoselaimessa, mutta älä valitse tiedostoa, vaan paina OK. 

Kun olet valinnut hakemiston tiedostolle, jonka aiot transkoodata, näet palautetta valinnastasi 
GTranscode -syöttöalueen keskellä: 

Probed Info about Input Video (audio not probed)— 



File: /caro.avi ( 1 files) 
Size: 480x360 

Frame Rate: 25.000 frames/sec 
Length: 89010 frames => Oh 59rn 20s 
Audio: 48000 Hz, 16 bit/sample, 2 channels 



Yllä on palaute yhdestä tiedostosta. Jos olet ladannut hakemiston, palaute näyttää suunnilleen 
tältä: 



Probed Info about Input Video (audio not probed) 



File: /home/eset/movies/ (2 files) 
Size: 480x360 

Frame Rate: 25.000 frarnes/sec 
Length: 124914 frames => 1h 23m 16s 
Audio: 48000 Hz, 16 bit/sample, 2 channels 



Sinun tulisi aina katsoa palautteesta oletko valinnut oikean tiedoston. 



Tuontimoduuli (import module) 

import module 



auto (use probed) A 



Tuontimoduuli dekoodaa sisääntulevan tiedoston. On olemassa monta tuontimoduulia, mutta on 
parasta antaa sovelluksen tunnistaa automaattisesti tiedostomuoto ja valita käytettävä moduuli. 
Älä muuta automaattivalinnan oletusarvoa auto (use probed), paitsi jos sinulla on ongelmia 
lukea tiedostoja tällä sovelluksella. 

Ruudut (frames) 



frames (blank = ALL) e.g. f 1-f2 



Voit transkoodata vain osan videotiedostosta. Siinä tapauksessa voit määritellä tähän kenttään 
alkuruudun ja loppuruudun osasta, joka transkoodataan. Silloin formaatti on f1-f2, jossa fl on 
aloitusruutu ja f2 on loppuruutu. Tässä on esimerkki: 

frames (blank = ALL) e.g. f 1-f2 1 10-500 



ULOSTULOALUE 



Käyttöliittymän oikealla puolella näet tietoa ja vaihtoehtoja, jotka liittyvät tiedostotyyppiin, jonka 
tahdot luoda. 

Ulostulotiedosto (Output Video File) 

Ulostulotiedosto on se alue, jota käytät valitaksesi tiedostojärjestelmästä alueen, johon tahdot 
tallettaa tiedostosi. Sinun tulee myös määritellä tiedostonimi transkoodatulle tiedostolle. Jos et 
ole varma tiedostotyypin loppuliitteestä, älä kirjoita sitä tässä vaiheessa. Seuraava riittää hyvin: 



Output Video File /data/movies/aa| 



Browse 



Voit valita sopivan loppupäätteen myöhemmin, mikäli on tarvetta. 

Läpimeno vai täysi prosessointi (Pass Through vs Full Processing) 

Käyttöliittymän oikealla puolella voit myös valita läpimenon (Pass Through) tai täysprosessoinnin 
(Full Processing). 
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Täysprosessointi merkitsee, että videostreami dekoodataan ensin ja enkoodataan sen jälkeen 
uuteen tiedostoon. Läpimeno merkitsee, että se luetaan ilman dekoodausta ja kirjoitetaan 
ulostulotiedostoon, mikä on tapa muuttaa formaattia ilman menetyksiä. 

Video Gptions 

a Direct Strearn Copy (pass-through) 
v Full Processing Mode 



Yleensä kannattaa valita täysi prosessointi. 
Täyden prosessoinnin vaihtoehdot 

Valittuasi täyden prosessoinnin näet seuraavat vaihtoehdot: 



-c|-nln::.i 

'.-+■.! I 1 1 UVMkJjJ i 



J 



■ ■=-:■ ^<i: :h i h ■ : Ii J I -j ik ja- \\rf. 



■ ■ "ii rrwrar.kT| *.V, | 
tynl imku- ::»ic4 : kh|i | 



Aiv*. Ifcm J4Jt.Yv.-j 
r [mi - Vm i rf.-m j m - j . | 



r : -h<Hj< »j-h I inl-i | 
i j-A-TV^YY-iaHiA- Ku k* {uHja* iu; r \w ^\ "T^<VM"\nt-' j 

• ■ .- -1:1*4. iitJ _- Lta- 

j^, --ii-, ikwr. iBp ijclb- 

juu |jremw 



I . iTi jj.i | x| 

ti hmfl r .-h V.r-AVV l-VH^I Um-ic*. \ .ac* 

j W.Tfi I — .¥Vl MH 



Nämä vaihtoehdot määrittelevät luomasi tiedoston muodon. 
Vientimoduuli (Export Module) 



export module ■ Ira 



Vientimoduulin asetus määrittelee luodun tiedoston formaatin. Nykyisin Transcode ja Gtranscode 
muuntavat moniin formaatteihin, joihin sisältyy DivX, XviD, DivX 4, DivX 5, AVI, MPEG, raw 
DV ja muitakin. Täyden listan näet Transcode VVikissä (http://www.transcoding.org/cgi- 
bin/transcode?Export_Modules) . Valitettavasti GTranscodessa ei ole siistiä pudotusvalintoa, sen 
sijaan joudut kirjoittamaan tiedon tämän tiedon kenttään. Esimerkiksi transkoodataksesi 
muotoon DIVX 5 joudut kirjoittamaan kenttään divx5. Voisit kirjoittaa esimerkiksi nämä moduulit 
vientimoduulikenttään: 

• mpeg2enc 

• xvid 

• divx5 

• mpe1 

Lisäksi voit kirjoittaa muita vaihtoehtoja vientimoduulille, jonka olet valinnut. Tietääkseni tämän 
sinun pitäisi tietää muutamia komentorivin vaihtoehtoja Transcodesta, jotka voisit kirjoittaa 
vientimoduulikenttään. GTranscoden peruskäytössä tästä ei tarvitse välittää. 

Ruututaajuus (frame rate) 
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frame rate (fps) 



auto (same as input) A 



Ruututaajuus on ulostulotiedoston ruutujen määrä sekunnissa. Jos jätät tämän kentän tyhjäksi, 
alkuperäisen tiedoston ruututaajuus säilytetään. 

Limityksen poisto (deinterlace mode) 



Limitys jakaa videon kahdeksi erilliseksi skannauslinjaksi yhdessä ruudussa. Analoginen 
televisioformaatti käyttää limitettyä videota. Kun limitettyä videota katsotaan televisiossa se 
näyttää hyvälle, mutta tietokoneella video näyttää sarjan linjoja videossa. Limitetyistä 
videotiedostoista täytyy poistaa limitys, että ne näyttävät hyvälle tietokoneella. Transkoodaus 
voi tehdä tämän, ja limittämätöntä videota sanotaan progressiiviseksi tai limittämättömäksi 
videoksi. 

Jos tahdot poistaa limityksen, sinun pitää kokeilla saatavilla olevia vaihtoehtoja, aloittaen 
mahdollisesti valitsemalla valikosta vaihtoehdon interpoloida skannauslinjat (interpolate 
scanlines) pudotusvalikosta. 



Videoon voi tulla limityksen poiston seurauksena ylimääräisiä artifakteja, jotka ovat "sotkuisia" 
viivoja. Poistaaksesi tämän häiriön voit valita erilaisia anti-alias-menetelmiä. Anti-alias- 
menetelmät eivät poista häiriöitä, mutta piilottavat ne, joten ne eivät näy niin selvästi. Sinun 
tarvitsee ainoastaan kokeilla näillä eri vaihtoehdoilla, jos olet poistamassa videon limitystä. 

Videon bittinopeus (video bitrate) 



video bitrate (kbits/sec) | 

Tämä vaihtoehto valitsee transkoodatun ulostulotiedoston bittinopeuden. Bittinopeus on hyvin 
olennainen asia videotiedoston lopullista laatua ajatellen. Mitä suurempi bittinopeus on, sitä 
suurempi laatu on, ja sitä suurempi tiedoston koko on. Jos olet enkoodaamassa tiedostoa 
välitettäväksi internetissä, tai jos sinulla on rajoittunut varastointitila, bittinopeudesta tulee hyvin 
tärkeä kysymys. Bittinopeuden asetus riippuu sinusta, mutta useimmiten et tahdo käyttää alle 
64 kbps bittinopeutta. Voit kokeilla bittinopeuksia 100, 200 ja 1600 tarjotussa kentässä. 

Säilytä kuvasuhde (preserve aspect ratio) 



■ preserve aspect ratio | x | 

Jos tahdot muuttaa ulostulovideon korkeutta ja leveyttä, voit käyttää näitä kenttiä. Jos tahdot 
muuttaa videon kokoa mutta säilyttää korkeuden ja leveyden suhteen, voit painaa vasemmalla 
olevan laatikon pohjaan. Jos tehdot tehdä näin, voit kirjoittaa haluamasi korkeuden ja ohjelma 
laskee oikean leveyden tai päinvastoin. Voit kuitenkin päättää olla säilyttämättä kuvasuhdetta, 
missä tapauksessa saat outoja mutta kiinnostavia tuloksia. 

Use YUV 

Älä muuta tätä vaihtoehtoa, ellet tiedä mitä olet tekemässä! 
Käännä, pyöräytä, peilaa (Swap, flip, mirror) 



deinterlace mode 




Antialias 



antialias mode 
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Näitä ei kannata käyttää, ellet tahdo muuttaa ulostulotiedostoa dramaattisesti. 



ÄÄNIVAIHTOHDOT (AUDIO OPTIONS) 



Tämä alue määrittelee äänen transkoodauksen ulostulon vaihtoehdot. Voit taas valita 
täysprosessoinnin (Full Processing) tai läpimenon (Pass-Through). Jos valitset 
täysprosessoinnin, näet monia eri vaihtoehtoja: 

Täysprosessointi 



Audio Gptions 

v Direct Strearn Copy (pass-through) 



A Full Processing Mode 



audio format |MPEG layer-3 aka MP3 



audio bitrate (kbits/sec) |64 
volume gain (1=same as input) 



Ääniformaatti (audio format) 

Valitse tämä pudotuslaatikosta, jossa on mahdolliset formaatit, joihin voit muuntaa äänen. 
Äänen bittinopeus (audio bitrate) 

Tämä vaikuttaa merkittävästi äänen laatuun ja lopullisen videon kokoon, aivan kuin videon 
bittinopeus vaikutti videoon. Kokeile näillä arvoilla. 

Äänen vahvistus (volume gain) 

Vahvistus on tapa tehostaa äänen kuuluvuutta. Jos alkuperäisen tiedoston ääni on liian hiljainen, 
voit kokeilla tällä arvolla, jätä se muuten arvoon 1. 

KOMENTORIVINÄYTTÖ 

Transcoden komentorivin oppimista varten GTranscoden alaosassa on kenttä, jossa näet 
komennon, joka vastaa käyttöliittymässä valitsemiasi vaihtoehtoja. 



transcode -i 7|öarö,avi" -c 10-500 -y -F -ss -I 1 -Z 200x150 -V -k -N 0x55 -b 64 -o 
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GTRANSCODEN KÄYTTÖ 



On monta tapaa käyttää GTranscodea, joten on vaikeaa näyttää niitä kaikkia, tässä on kuitenkin 
esimerkki avi-tiedoston muuttamisesta divx-tiedostoksi, ja kuvasuhteen, videon bittinopeuden ja 
kuvataajuuden muuttamisesta. 

AVAA LÄHDETIEDOSTO 

Ensin lataamme oikean tiedoston avaamalla GTranscoden ja painamalla Browse: 
Video File or Directory | Browse| 
Tämä avaa tiedostoselaimen, ja sinun tulisi valita tiedosto transkoodattavaksi: 



Create Dir 



Delete File Renarne File 



/home/eset 



Directories 



./ 
../ 

Desktop/ 
RealPlayer/ 
eliza/ 
extras/ 
g trans/ 



Files 



RealPlayer1GGGLD.bin 

aco.tgz 

c:\trace_b.txt 

gpodder_0.7-2_all.deb 

gtranscode-v0.3.tar.gz 

vlc-0.8.4a.tar.gz 

vlc-0.8.5.tar.gz 



Selection: /home/eset 



OK Cancel 



Tässä vaihtoehdossa valitsemme caro.avi -videon: 
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Create Dir | Delete File | Renarne File 
/home/esetfinovies _i 



Directories 



Files 



k.avi 



Selection: /home/eset/rnovies 



caro.avi 



OK 



Cancel 



Valitse (korosta) tiedosto, jonka tahdot, paina OK, ja näet käyttöliittymän päänäkymässä tietoa 
tiedostosta: 



Input 

Video File or Directory 
Audio File (optional)l 



/horne/esetfrnovies/caro.a^ 



Browse 



Browse 



import module 
frames (blank = ALL) e.g. f 1-f2 



auto (use probed) / 



Probed Info about Input Video (audio not probed) 

File: /home/eset/movies/caro.avi (1 files) 
Size: 480x360 

Frame Rate: 25.000 frames/sec 
Length: 17952 frames => Oh 1 1 m 58s 
Audio: 48000 Hz, 16 bit/sample, 2 channels 



ULOSTULON ASETUKSET 

Nyt tahdot valita ulostulotiedoston formaatin. 

Valitse ulostulotiedosto (Choose Output File) 



Sinun täytyy tallentaa lopullinen transkoodattu tiedosto johonkin, tehdäksesi tämän sinun täytyy 
kirjoittaa polku ja tiedostonimi kohtaan ulostulotiedosto (Output Video File). Jos et tiedä mikä 
polku on, paina Browse: 



Output Video File Browse 
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Kun olet painanut Browse, näet taas tiedostoselaimen: 



Create Dir Delete File Renarne File 



/home/eset 



Directories 



./ 
../ 

Desktop/ 
RealPlayer/ 
eliza/ 
extras/ 
g trans/ 



Files 



RealPlayer10GOLD.bin 

aco.tgz 

c:\trace_b.txt 

gpodder_0.7-2_all.deb 

gtranscode-v0.3.tar.gz 

vlc-0.8.4a.tar.gz 

vlc-0.8.5.tar.gz 



Selection: /home/eset 



OK 



Cancel 



Selaa nyt hakemistoon, johon tahdot tallentaa transkoodatun tiedoston, ja kirjoita tiedostonimi 
alimpaan kenttään: 



Create Dir Delete File Renarne File 



/home/esetfmovies 



Directories 



./ 



Files 



caro.avi 
k.avi 



Selection: /home/eset/rnovies 



newfile.divx| 



OK 



Cancel 



Paina nyt OK ja uuden tiedostopolkusi nimi ja polku tulee näkyviin: 



Output Video File /home/eset/ rnovies/newfile.divx Browse 
Täysprosessointitila (Full Processing Mode) 

Paina nyt nappia Full Processing Mode. Näet nyt joitain vaihtoehtoja, joista voit valita, ja jotka 
määrittävät ulostulotiedoston formaatin. 
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$ Full Processing Mode 


export module 


/ 


pynnrt rnnrli iIp riritinnsl ^Irinn 

CAUUI L 1 1 IUUUIC UULIUI Icll o LI II IU 




frame rate (fps) 


auto (same as input) / 


deinterlace mode 


none / 


antialias mode 


none / 


video bitrate (kbits/sec) 






■ preserve aspect ratio f x | 






r use YUV/YV 12/1420 internally (usually much faster) 


j swap red and blue 






jflip upside down 






j mirror 







Emme käytä useimpia näistä, mutta valitsemme asetukset vientimoduulille, ruututaajuudelle, 
videon bittinopeudelle ja kuvasuhteelle. 

Nyt valitsemme seuraavat vaihtoehdot: 

• export module : divx5 

• frame rate : 12 

• video bitrate : 64 

• aspect ratio : 200 x 150 

Jos täytät nämä vaihtoehdot käyttöliittymään, se näyttää suunnilleen tältä: 



g Full Processing Mode 






export module 


divx5 Jj 


export module optional string 




frame rate (fps) 


12 / 


deinterlace mode 


none / 


antialias mode 


none / 


video bitrate (kbits/sec) 




64 


r preserve aspect ratio |200 x 1 150 





KOMENTORIVIN ULOSTULO 

Jos katsot käyttöliittymän alaosaa, näet tiedot komennosta, jota käyttäisit komentorivillä: 

transcode -i "/home/eset/movies/caro . avi " -P 2 -y divx5 -f 12 -w 64 -Z 200x150 -V 
-o "/home/eset/movies/newf ile . divx" 

ALOITA TRANSKOODAUS 

Valitse nyt go valikosta File: 



File About 



GO! (transcode) 
Quit 
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Jos kaikki menee hyvin, näet jotain tällaista: 



running transcode . 



[export_divx5.so] vO.1.8 (2003-07-24) (video) DivX 5.xx | (audio) MPEG/AC3/ s 
PCM 

import_avi.so] format=0x55 J rate=48000 Hz, bits=16, channels=2, bitrate=139 

transcode] V: import frame | 480x360 1 .33: 1 

transcode] V: zoom | 200x150 1.33:1 (Lanczos3) 

transcode] V: bits/pixel | 0.178 

transcode] V: decoding fps,frc | 12.000,0 

transcode] V: TCbCr | YV 12/1420 

transcode] A: import format | 0x55 MPEG layer-3 [48000,16,2] 139 kbps 

transcode] A: export format j 0x1 PCM [48000,16,2] 139 kbps 

transcode] V: encoding fps,frc | 12.000,12 

transcode] A: bytes per frame | 16000(16000.000000) 

transcode] A: adjustment | 0@ 1000 

transcode] A: pass-through | yes 

transcode] V: IA32 accel mode | sse2 (sse2 sse mmxext mmx asm C) 
transcode] V: video buffer | 50 @ 480x360 
export_divx5.so] frame height 150 (no multiple of 8) 
export_divx5.so] encoder may not work correctly or crash 



cancel 



9% 



Kun tiedoston transkoodaus on valmis, voit katsoa sen! 

Tekijät 
5. Lisenssi 
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5- LISENSSI 



Kaikki kappaleet ovat kirjoittajien tekijänoikeuden alaisia. Jos muuten ei sanota, kaikki luvut tässä 
käyttöoppaassa on lisensoitu GNU General Public License version 2 mukaisesti. 

Tämä dokumentaatio on vapaata dokumentaatiota: voit jakaa sitä eteenpäin ja/tai muokata sitä 
Free Software Foundationin GNU General Public License mukaisesti; joko lisenssin version 2, tai 
(tahtoessasi) minkä tahansa myöhemmän version. 

Dokumentaatiota jaellaan siinä toivossa, että se on käyttökelpoisa, mutta ILMAN MITÄÄN 
TAKUUTA; ilman edes MYYTÄ VYYDEN tai TIETTYYN KÄYTTÖÖN SOPIVUUDEN oletettua takuuta. 
Katso lisätietoja GNU General Public Licensestä. 

Tämän dokumentaation mukana olisi pitänyt tulla kopio GNU General Public Licensestä, mikäli 
sitä ei tullut kirjoita osoitteeseen Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 
Boston, MA 02110-1301, USA. 



ENGLANNINKIELISEN VERSION KIRJOITTAJAT 

CREDIT5 

© adam hyde 2006, 2007 
LINUX 

© adam hyde 2006 
Modifications: 
Irene Yi 2007 



INTERFACE 

© adam hyde 2006 

Modifications: 

Irene Yi 2007 



INTRODUCTION 

© adam hyde 2006, 2007 

Modifications: 

Irene Yi 2007 



BASIC EXAMPLE 
© adam hyde 2006 
Modifications: 
Irene Yi 2007 



SUOMENKIELISEN VERSION KÄÄNTÄJÄT JA KIRJOITTAJAT 

Tekijät 

© adam hyde 2006, 2007 

Modifications: 

Tomi Toivio 2010 

Asennus 

© TWikiGuest 2010 
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Modifications: 
Tomi Toivio 2010 



Käyttöliittymä 
© TWikiGuest 2010 
Modifications: 
Tomi Toivio 2010 



Johdanto 

© adam hyde 2006, 2007 
Modifications: 
Tomi Toivio 2010 
TVVikiGuest 2010 



Käyttö 

© TVVikiGuest 2010 
Modifications: 
Tomi Toivio 2010 



□ 



FLOSS 

MANUALS 



Free manuals for free software 



GENERAL PUBLIC LICENSE 

Version 2, June 1991 

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA 

Everyone is permitted to copy and distribute verbatim copies 
of this license document, but changing it is not allovved. 

Preamble 

The licenses for most software are designed to take away your freedom to share and change it. 
By contrast, the GNU General Public License is intended to guarantee your freedom to share and 
change free software--to make sure the software is free for ali its users. This General Public 
License applies to most of the Free Software Foundation's software and to any other program 
whose authors commit to using it. (Some other Free Software Foundation software is covered by 
the GNU Lesser General Public License instead.) You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General Public 
Licenses are designed to make sure that you have the freedom to distribute copies of free 
software (and charge for this service if you wish), that you receive source code or can get it if 
you want it, that you can change the software or use pieces of it in new free programs; and that 
you know you can do these things. 

To protect your rights, we need to make restrictions that forbid anyone to deny you these rights 
or to ask you to surrender the rights. These restrictions translate to certain responsibilities for 
you if you distribute copies of the software, or if you modify it. 
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For example, if you distribute copies of such a program, vvhether gratis or for a fee, you must 
give the recipients ali the rights that you have. You must make sure that they, too, receive or 
can get the source code. And you must show them these terms so they knovv their rights. 

We protect your rights vvith tvvo steps: (1) copyright the software, and (2) offer you this license 
which gives you legal permission to copy, distribute and/or modify the software. 

Also, for each author's protection and ours, we want to make certain that everyone understands 
that there is no warranty for this free software. If the software is modified by someone else and 
passed on, we want its recipients to know that what they have is not the original, so that any 
problems introduced by others will not reflect on the original authors' reputations. 

Finally, any free program is threatened constantly by software patents. VVe wish to avoid the 
danger that redistributors of a free program will individually obtain patent licenses, in effect 
making the program proprietary. To prevent this, we have made it clear that any patent must 
be licensed for everyone's free use or not licensed at ali. 

The precise terms and conditions for copying, distribution and modification follow. 
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 

0. This License applies to any program or other work which contains a notice placed by the 
copyright holder saying it may be distributed under the terms of this General Public License. The 
"Program", below, refers to any such program or work, and a "work based on the Program" 
means either the Program or any derivative work under copyright law: that is to say, a work 
containing the Program or a portion of it, either verbatim or with modifications and/or translated 
into another language. (Hereinafter, translation is included without limitation in the term 
"modification".) Each licensee is addressed as "you". 

Activities other than copying, distribution and modification are not covered by this License; they 
are outside its scope. The act of running the Program is not restricted, and the output from the 
Program is covered only if its contents constitute a work based on the Program (independent of 
having been made by running the Program). Whether that is true depends on what the Program 
does. 

1. You may copy and distribute verbatim copies of the Program's source code as you receive it, 
in any medium, provided that you conspicuously and appropriately publish on each copy an 
appropriate copyright notice and disclaimer of warranty; keep intact ali the notices that refer to 
this License and to the absence of any warranty; and give any other recipients of the Program a 
copy of this License along with the Program. 

You may charge a fee for the physical act of transferring a copy, and you may at your option 
offer warranty protection in exchange for a fee. 

2. You may modify your copy or copies of the Program or any portion of it, thus forming a work 
based on the Program, and copy and distribute such modifications or work under the terms of 
Section 1 above, provided that you also meet ali of these conditions: 

a) You must cause the modified files to carry prominent notices stating that you changed 
the files and the date of any change. 

b) You must cause any work that you distribute or publish, that in whole or in part 
contains or is derived from the Program or any part thereof, to be licensed as a whole at 
no charge to ali third parties under the terms of this License. 

c) If the modified program normally reads commands interactively when run, you must 
cause it, when started running for such interactive use in the most ordinary way, to print 
or display an announcement including an appropriate copyright notice and a notice that 
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there is no vvarranty (or else, saying that you provide a vvarranty) and that users may 
redistribute the program under these conditions, and telling the user hovv to vievv a copy of 
this License. (Exception: if the Program itself is interactive but does not normally print such 
an announcement, your vvork based on the Program is not required to print an 
announcement.) 

These requirements apply to the modified vvork as a vvhole. If identifiable sections of that vvork 
are not derived from the Program, and can be reasonably considered independent and separate 
vvorks in themselves, then this License, and its terms, do not apply to those sections vvhen you 
distribute them as separate vvorks. But vvhen you distribute the same sections as part of a 
vvhole vvhich is a vvork based on the Program, the distribution of the vvhole must be on the terms 
of this License, vvhose permissions for other licensees extend to the entire vvhole, and thus to 
each and every part regardless of vvho vvrote it. 

Thus, it is not the intent of this section to claim rights or contest your rights to vvork vvritten 
entirely by you; rather, the intent is to exercise the right to control the distribution of derivative 
or collective vvorks based on the Program. 

In addition, mere aggregation of another vvork not based on the Program vvith the Program (or 
vvith a vvork based on the Program) on a volume of a Storage or distribution medium does not 
bring the other vvork under the scope of this License. 

3. You may copy and distribute the Program (or a vvork based on it, under Section 2) in object 
code or executable form under the terms of Sections 1 and 2 above provided that you also do 
one of the follovving: 

a) Accompany it vvith the complete corresponding machine-readable source code, vvhich 
must be distributed under the terms of Sections 1 and 2 above on a medium customarily 
used for software interchange; or, 

b) Accompany it vvith a vvritten offer, valid for at least three years, to give any third party, 
for a charge no more than your cost of physically performing source distribution, a 
complete machine-readable copy of the corresponding source code, to be distributed under 
the terms of Sections 1 and 2 above on a medium customarily used for software 
interchange; or, 

c) Accompany it with the information you received as to the offer to distribute 
corresponding source code. (This alternative is allowed only for noncommercial distribution 
and only if you received the program in object code or executable form with such an offer, 
in accord with Subsection b above.) 

The source code for a work means the preferred form of the work for making modifications to 
it. For an executable work, complete source code means ali the source code for ali modules it 
contains, plus any associated interface definition files, plus the scripts used to control compilation 
and installation of the executable. However, as a special exception, the source code distributed 
need not include anything that is normally distributed (in either source or binary form) with the 
major components (compiler, kernel, and so on) of the operating system on which the executable 
runs, unless that component itself accompanies the executable. 

If distribution of executable or object code is made by offering access to copy from a designated 
place, then offering equivalent access to copy the source code from the same place counts as 
distribution of the source code, even though third parties are not compelled to copy the source 
along with the object code. 
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4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided 
under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program 
is void, and vvill automatically terminate your rights under this License. Hovvever, parties who 
have received copies, or rights, from you under this License vvill not have their licenses 
terminated so long as such parties remain in full compliance. 

5. You are not required to accept this License, since you have not signed it. Hovvever, nothing 
else grants you permission to modify or distribute the Program or its derivative vvorks. These 
actions are prohibited by lavv if you do not accept this License. Therefore, by modifying or 
distributing the Program (or any vvork based on the Program), you indicate your acceptance of 
this License to do so, and ali its terms and conditions for copying, distributing or modifying the 
Program or vvorks based on it. 

6. Each time you redistribute the Program (or any vvork based on the Program), the recipient 
automatically receives a license from the original licensor to copy, distribute or modify the 
Program subject to these terms and conditions. You may not impose any further restrictions on 
the recipients' exercise of the rights granted herein. You are not responsible for enforcing 
compliance by third parties to this License. 

7. If, as a consequence of a court judgment or allegation of patent infringement or for any other 
reason (not limited to patent issues), conditions are imposed on you (vvhether by court order, 
agreement or othervvise) that contradict the conditions of this License, they do not excuse you 
from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your 
obligations under this License and any other pertinent obligations, then as a consequence you 
may not distribute the Program at ali. For example, if a patent license vvould not permit royalty- 
free redistribution of the Program by ali those vvho receive copies directly or indirectly through 
you, then the only vvay you could satisfy both it and this License vvould be to refrain entirely 
from distribution of the Program. 

If any portion of this section is held invalid or unenforceable under any particular circumstance, 
the balance of the section is intended to apply and the section as a vvhole is intended to apply in 
other circumstances. 

It is not the purpose of this section to induce you to infringe any patents or other property right 
claims or to contest validity of any such claims; this section has the sole purpose of protecting 
the integrity of the free software distribution system, vvhich is implemented by public license 
practices. Many people have made generous contributions to the vvide range of software 
distributed through that system in reliance on consistent application of that system; it is up to 
the author/donor to decide if he or she is willing to distribute software through any other system 
and a licensee cannot impose that choice. 

This section is intended to make thoroughly clear what is believed to be a consequence of the 
rest of this License. 

8. If the distribution and/or use of the Program is restricted in certain countries either by 
patents or by copyrighted interfaces, the original copyright holder who places the Program under 
this License may add an explicit geographical distribution limitation excluding those countries, so 
that distribution is permitted only in or among countries not thus excluded. In such case, this 
License incorporates the limitation as if written in the body of this License. 

9. The Free Software Foundation may publish revised and/or new versions of the General Public 
License from time to time. Such new versions will be similar in spirit to the present version, but 
may differ in detail to address new problems or concerns. 

Each version is given a distinguishing version number. If the Program specifies a version number 
of this License which applies to it and "any later version", you have the option of following the 
terms and conditions either of that version or of any later version published by the Free 
Software Foundation. If the Program does not specify a version number of this License, you may 
choose any version ever published by the Free Software Foundation. 
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10. If you vvish to incorporate parts of the Program into other free programs vvhose distribution 
conditions are different, vvrite to the author to ask for permission. For software which is 
copyrighted by the Free Software Foundation, write to the Free Software Foundation; we 
sometimes make exceptions for this. Our decision will be guided by the two goals of preserving 
the free status of ali derivatives of our free software and of promoting the sharing and reuse of 
software generally. 

NO VVARRANTY 

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO VVARRANTY FOR THE 
PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT VVHEN OTHERVVISE 
STATED IN VVRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE 
PROGRAM "AS IS" VVITHOUT VVARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED VVARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND 
PERFORMANCE OF THE PROGRAM IS VVITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, 
YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY 
COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE 
PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY 
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR 
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA 
BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A 
FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER 
OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 

END OF TERMS AND CONDITIONS 
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